home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / love4th.zip / WORKING.DOC < prev   
Text File  |  1991-10-01  |  4KB  |  92 lines
  1.         Working In L.O.V.E. Forth
  2.  
  3.         Here are some notes on how to do day to day work in L.O.V.E.
  4. Forth.  A good starting point for viewing the features, is given in the
  5. share-ware demo LOVES.EXE .
  6.  
  7.         Help
  8.  
  9.         For help while using the system, load the Hyper Helper with the
  10. DOS command:  HM LOVE  before running Forth.  Or execute GO.BAT or
  11. BARE.BAT .  The help system is subsequently invoked the the key
  12. sequence:  ALT-F1 .
  13.  
  14.         Directories
  15.  
  16.         Usually, the programmer copies Forth to the working directory
  17. including source code etc.  When copying the EXE to another directory,
  18. be sure to also copy the  *.VTR files.  These are the virtual
  19. vocabularies.  Alternatively the DOS APPEND command can be used to direct
  20. DOS to the appropriate directory.
  21.  
  22.         Versions of L.O.V.E. Forth
  23.  
  24.         The minimum system, with the smallest number of features
  25. compiled is called MINnnn.EXE where nnn is the version number (eg.
  26. MIN126.EXE ).  This is the program executed by BARE.BAT .  On top of
  27. this can be the block disk words (LOADBLK.TXT) and / or the RPN
  28. assembler.  Be sure to save the system again with SAVE" after loading
  29. the desired features (eg.  SAVE" LOVERPN.EXE" ).
  30.  
  31.         Various source code modules can be loaded ontop of the BARE
  32. system.  These include local variables, multiple CFA words,
  33. miscellaneous words.  Dependancies:
  34.  
  35.         LOADBLK.TXT     also loads MISC.TXT
  36.         ARRAY.TXT       requires   MCFA.TXT
  37.  
  38. All others can be loaded independantly.
  39.  
  40.         Upper and Lower Case
  41.  
  42.         Normally, the case of a word is ignored.  By setting variable
  43. CASEMATCH to true, however, will cause L.O.V.E. Forth to match the case
  44. of the word as it originally was compiled.   All the L.O.V.E. Forth
  45. standard words were compiled in upper case.  Compilation is slightly
  46. faster in case match mode, but it is usually desireable to type
  47. interactive commands with case ignored.
  48.  
  49.         Text strings
  50.  
  51.         Frequently the programmer requires control characters in
  52. strings.  This is difficult to do in any text file, as control
  53. characters may be editor commands, or printer control codes.  L.O.V.E.
  54. Forth supports AWK style escape commands.  These are summarized as
  55. follows:
  56.           \b   : backspace
  57.           \f   : formfeed
  58.           \n   : newline, linefeed
  59.           \r   : carriage return
  60.           \t   : tab
  61.           \ddd : decimal value, 1 to 3 digits
  62.           \c   : where 'c' is any other character literally
  63.           \\   : for backslash
  64.           \"   : for "
  65.  
  66.         These can be used in text strings compiled with the words:
  67.         ."  "  ,"  .(
  68.  
  69.         Vocabularies
  70.  
  71.         See also the section describing vocabularies.  The usual
  72. vocabulary for working in Forth is FORTH.  The words controlling the
  73. dictionary search order are in vocabulary ROOT .  The word DEVELOP
  74. sets the search order to be  ROOT FORTH and TOOLBOX which contains
  75. programming aids.    The vocabulary implementation is that of a stack,
  76. ALSO pushes the stack and VDROP drops the top of the stack.  ONLY
  77. resets it to ROOT only.
  78.  
  79.         Access to DOS
  80.  
  81.         Typing the word DOS followed by a DOS command line, executes
  82. that in a DOS shell.  Typing DOS followed by nothing, enters the DOS
  83. shell (typing EXIT returns to Forth).  This is one way to invoke a text
  84. editor.   Note that there must be enough memory to invoke DOS.  If too
  85. much memory is allocated in MAXHEAP (see instructions on saving the
  86. system), DOS cannot be entered.
  87.  
  88.         Windows 3.0
  89.  
  90.         The multitasking features of this environment are useful.  One
  91. can run L.O.V.E. Forth from a DOS prompt, and have an editor running in
  92. another window.  The L.O.V.E. Forth icon is provided.